Книги-online

назад | содержание | вперед

Создание справочной системы в формате WinHelp

Основу справочной системы составляют темы с пояснительным текстом. Содержание справочной системы включает список тем, доступных в системе. Каждая тема имеет заголовок и уникальный символьный идентификатор. Дополнительно каждой теме можно поставить в соответствие уникальный индекс темы, который должен быть целым числом.

Для поиска темы в справочной системе служат ключи, содержащие название темы и ссылку на нее. Каждая тема может иметь более одного ключа поиска. Кроме того, один ключ может содержать ссылку на несколько тем.

Для организации контекстного вызова темы из справочной системы вы можете использовать числовые значения индексов или значения ключа. Употребление идентификаторов тем для контекстного вывода справочной информации не допускается.

Чтобы связать между собой отдельные темы, применяются перекрестные ссылки. При этом текст, используемый для организации перекрестной ссылки, выделяется зеленым цветом и подчеркиванием.

В описании любой системы присутствуют специфические термины. Например, в системах складского учета к таким терминам относятся накладном, счет, отпуск товара. Термином может быть не только отдельное слово, но и любая фраза из текста темы. Справочная система Windows позволяет дать краткое определение каждому термину приложения. Такие термины на экране выделены зеленым цветом и пунктирным подчеркиванием. Если щелкнуть мышью на термине, для которого определено краткое описание, оно появится на экране в рамке поверх текста темы.

Создание справочной системы в формате WinHelp включает следующие этапы:

1. Создание описания справочной системы. Для этого можно использовать любой текстовый редактор, поддерживающий формат RTF. Описание содержит темы, индексы и ключи справочной системы. Структура документа должна соответствовать требованиям, предъявляемым компилятором справочной системы (Help Compiler).

2. Формирование файла с расширением cnt, содержащего иерархическое содержание создаваемой справочной системы.

3. Формирование текстового файла с расширением hpj, содержащего параметры для компиляции справочной системы: имя файла с описанием справочной системы, заголовок справочной системы.

4. Компиляция созданного текстового описания с использованием Help Compiler, входящего в комплект Visual Basic.

5. Определение свойства HelpContextiD для требуемых объектов формы, а также создание в приложении кнопок и пунктов меню для вызова справочной системы.

Рассмотрим только средства, наиболее часто используемые при создании справочной системы. Подробную информацию вы найдете в руководстве по применению Help Compiler. В качестве примера создадим простую справочную систему, состоящую из нескольких тем. Для каждой темы определим заголовки, идентификаторы и ключи, служащие для поиска информации.

Замечание

При разработке справочной системы крупных приложений используются, как правило, специальные средства, например ForeHelp, содержащие интегрированную среду.

назад | содержание | вперед